home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / fdrc_100.arc / FDRC.DOC < prev    next >
Text File  |  1991-08-12  |  9KB  |  309 lines
  1.                *FDRC* - (F)ront(D)oor (R)emote (C)ontrol
  2.                -----------------------------------------
  3.  
  4.                        Version 1.00 / Aug 12 1991
  5.    Copyright (c) 1991 by Roland Gautschi, CH-5610 Wohlen, 2:302/561@fidonet
  6.  
  7.  
  8.  
  9. Some legal stuff
  10. ----------------
  11.  
  12. FDRC is provided as is, without warranty of any kind, either expressed
  13. or implied. Roland Gautschi only guarantees that FDRC will occupy disk
  14. space.
  15.  
  16. In no event shall Roland Gautschi be liable to you or anyone else for
  17. any damages, including any lost profits, lost savings or other
  18. incidental or consequential damages arising out of the use or inability
  19. to use this program.
  20.  
  21.  
  22. What it is:
  23. -----------
  24.  
  25. FDRC is a program to perform functions of Frontdoor either as a
  26. FDServer request or local. It is designed to run in multitasking or
  27. single line environments.
  28.  
  29. This functions are:
  30.  
  31.     - Force a poll on a system
  32.  
  33.     - Request file(s) from a system
  34.  
  35.     - Send file(s) to a system
  36.  
  37.     - Set netmail-messages including echomail-attaches and/or file-attaches
  38.       to a system to another status
  39.  
  40.     - Force FD to exit with a defined errorlevel
  41.  
  42.     - Force FD to rescan his messagebase
  43.  
  44.  
  45. Specifications:
  46. ---------------
  47.  
  48. - FDRC is 3D/4D point aware (using POINTNET environment variable)
  49.  
  50. - FDRC is zone aware (using ^AINTL addressing)
  51.  
  52.  
  53. Requirements:
  54. -------------
  55.  
  56.     - You need a PC-XT/AT running DOS 3.0 or later
  57.  
  58.     - 64 kB RAM
  59.  
  60.     - FD environment variable pointing to your FD directory
  61.  
  62.     - POINTNET environment variable set (not required but recommended)
  63.  
  64.  
  65. Installation:
  66. -------------
  67.  
  68. - Edit FDRC_REQ.TXT (appended to a request) and FDRC_ATT.TXT (appended
  69.   to a file-attach) to your own need.
  70.  
  71. - Copy FDRC.COM, FDRC_REQ.TXT and FDRC_ATT.TXT to a directory which
  72.   is included in the PATH variable.
  73.  
  74. FDRC gets first the directory where it finds FD.SYS from the FD
  75. environment variable, then it reads the other parameters from FD.SYS.
  76.  
  77. done!
  78.  
  79.  
  80. Usage:
  81. ------
  82.  
  83. Get the help screen
  84. - FDRC <empty> or HELP or /?
  85.  
  86. Force a poll
  87. - FDRC POLL <Address> [CRASH] [IMM] [KILL]
  88.  
  89. Request file(s)
  90. - FDRC GET  <FNAME [FNAME]..> FROM <Address> [CRASH] [IMM] [KILL] [UPD]
  91.  
  92. Send file(s)
  93. - FDRC SEND <FNAME [FNAME]..> TO <Address> [CRASH] [IMM] [KILL] [HOLD]
  94.  
  95. Change netmail(s)/echomail-attache(s) and/or file-attaches of a system
  96. - FDRC SET  <MAIL || FILES || ALL> TO <Address> [CRASH] [HOLD]
  97.  
  98. Force FD to exit
  99. - FDRC EXIT <errorlevel>
  100.  
  101. Force FD to rescan
  102. - FDRC RESCAN
  103.  
  104.  
  105. Descriptions of the commands:
  106. -----------------------------
  107.  
  108. POLL   Usage: FDRC poll <Address> [CRASH] [IMM] [KILL]
  109. ----
  110.        Poll system <Address> with the status:
  111.  
  112.        -  [CRASH] message becomes crash status
  113.  
  114.        -  [IMM]   message becomes immediate status
  115.  
  116.        -  [KILL]  message becomes kill/sent status
  117.  
  118.        -  If CRASH and IMM is not defined, the message becomes 'normal'
  119.           status which means there is no flag (CRASH/IMM) set.
  120.  
  121.        Address is either a full 4D address like
  122.  
  123.          2:302/561.2
  124.  
  125.        or a 3D address like
  126.  
  127.          2:6863/2  (6863 is my pointnet)
  128.  
  129.        or can be a short form like (my address is 2:302/561)
  130.  
  131.          short                 expanded by FDRC
  132.          --------------------------------------
  133.          .2                    2:302/561.2
  134.          560                   2:302/560.0
  135.          560.2                 2:302/560.2
  136.          300/0                 2:300/0.0
  137.          300/0.2               2:300/0.2
  138.          1:123/456             1:234/456.0
  139.  
  140.        Note:
  141.  
  142.        - FDRESCAN.NOW will be written to FD's system directory to force
  143.          FD to rescan the message base.
  144.  
  145. -------------------------------------------------------------------------------
  146.  
  147. GET    Usage: FDRC GET <FNAME [FNAME] ..> FROM <Address> [CRASH] [KILL] ...
  148. ---                                                      [HOLD] [IMM]
  149.  
  150.        Get file(s) from system <Address> with status:
  151.  
  152.        - [CRASH] [KILL] [IMM] same as POLL command
  153.  
  154.        - [UPD]   request is a update request. You must define the path
  155.                  to the file you already have.
  156.  
  157.        -  If CRASH and IMM is not defined, the message becomes 'normal'
  158.           status which means there is no flag (CRASH/IMM) set.
  159.  
  160.                  Example:
  161.  
  162.                  FDRC get c:\files\fd\fd_201.zip from 270/17 upd
  163.  
  164.        Address is the same as in the POLL command
  165.  
  166.        Note:
  167.  
  168.        - If you want request password protected file you can do it
  169.          either like this:
  170.  
  171.            FDRC get fname.ext!password from ....
  172.  
  173.          or this way:
  174.  
  175.            FDRC get fname.ext !password from ....
  176.  
  177.          both requests will be expanded to 'fname.ext !password'
  178.  
  179.          IF YOU WANT TO REQUEST A FILE CONTAINING A '!' IN THE NAME OR
  180.          EXTENSION YOU MUST USE A '?' AT THE PLACE OF THE '!'
  181.  
  182.        - If there is a file named FDRC_REQ.TXT found, either in the
  183.          current directory, or in the directory where FDRC.COM was
  184.          started from, then this file will be inserted in the
  185.          text of the request.
  186.  
  187.        - FDRESCAN.NOW will be written to FD's system directory to force
  188.          FD to rescan the message base.
  189.  
  190. -------------------------------------------------------------------------------
  191.  
  192. SEND   Usage: FDRC SEND <FNAME [FNAME]..> TO <Address> [CRASH] [KILL] ...
  193. ----                                                   [HOLD] [IMM]
  194.  
  195.        Send file(s) to system <Address> with status:
  196.  
  197.        - [CRASH] [KILL] [IMM] same as POLL command
  198.  
  199.        - [HOLD]  message becomes hold status
  200.  
  201.        -  If CRASH and HOLD is not defined, the message becomes 'normal'
  202.           status which means there is no flag (CRASH/HOLD) set.
  203.  
  204.        Address is the same as in the POLL command
  205.  
  206.        Note:
  207.  
  208.        - If there is a file named FDRC_ATT.TXT found, either in the
  209.          current directory, or in the directory where FDRC.COM was
  210.          started from, this file will be inserted in the
  211.          text of the request.
  212.  
  213.        - FDRESCAN.NOW will be written to FD's system directory to force
  214.          FD to rescan the message base.
  215.  
  216. -------------------------------------------------------------------------------
  217.  
  218. SET    Usage FDRC SET <MAIL || FILES || ALL> TO <Address> [CRASH] [HOLD]
  219. ---
  220.        Set all messages specified to system address to another status
  221.  
  222.        Examples:
  223.  
  224.          - Set all netmails and the echomail-attaches to 2:302/1 CRASH:
  225.  
  226.            FDRC set mail to 1 crash
  227.  
  228.          - Set all file-attaches to 2:302/1 HOLD
  229.  
  230.            FDRC set files to 1 hold
  231.  
  232.          - Set all mail/files to 2:302/1 to no status
  233.  
  234.            FDRC set all to 1
  235.  
  236.        Note:
  237.  
  238.          - Only messages which needs to be changed will be changed. Eg,
  239.            if a message is already HOLD and you request to change it to
  240.            hold there is notingh done.
  241.  
  242.          - If messages are changed, FDRESCAN.NOW will be written to FD's
  243.            system directory.
  244.  
  245. -------------------------------------------------------------------------------
  246.  
  247. EXIT   Usage: FDRC exit <errorlevel>
  248. ----
  249.        Forces FD to exit with <errorlevel>
  250.  
  251.        Note:
  252.  
  253.          - errorlevel can be in 1..255
  254.  
  255. -------------------------------------------------------------------------------
  256.  
  257. RESCAN Usage: FDRC rescan
  258. ------
  259.        Forces FD to rescan his messagebase.
  260.  
  261.        Note:
  262.  
  263.          - this command is *NOT* requiered if POLL/GET/SEND/SET was
  264.            executed before, because this commands do a rescan request
  265.            automatic.
  266.  
  267. -------------------------------------------------------------------------------
  268.  
  269.  
  270. Technical informations:
  271. -----------------------
  272. - FDRC is written in BorlandC++ 2.0 and compiled in the Tiny memory model.
  273. - It changes to the specified drive/directory to do all the stuff, and
  274.   returns *always* back to the drive/directory where it's called from.
  275. - It uses DOS 3.0 / share file locking method while reading the archives.
  276. - It uses BIOS calls for screenwrites and runs well in an DesqView
  277.   environement
  278.  
  279.  
  280. How to get help
  281. ---------------
  282.  
  283. You can reach me via netmail at:
  284.  
  285. 2:302/561@fidonet
  286.  
  287. or via snail-mail at:
  288.  
  289. Roland Gautschi
  290. Sorenbuehlweg 39
  291. 5610 Wohlen
  292.  
  293. Switzerland
  294.  
  295. Thanks
  296. ------
  297.  
  298. Thanks goes to
  299.  
  300. - Joaquim Homrighausen for his great program 'Frontdoor'
  301.  
  302. and to all my beta-testers:
  303.  
  304. - Ruedi Kneubuehler (2:302/480)
  305. - Patrick Oeticker  (2:302/560)
  306. - Nik Bombelli      (2:302/1)
  307.  
  308. [*EOF*]
  309.